<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<title>xxdiff-qt6: Updated Graphical File And Directories Comparator And Merge Tool</title>
<link rel="stylesheet" href="style.css" type="text/css" />
</head>
<body>

<div id="project-header">
  <a href="/home/index.html"><img src="/home/furius-logo-w.png" id="logo"></a>
</div>

<div class="document" id="xxdiff-qt6-updated-graphical-file-and-directories-comparator-and-merge-tool">
<h1 class="title">xxdiff-qt6: Updated Graphical File And Directories Comparator And Merge Tool</h1>

<!-- -*- coding: utf-8 -*- -->
<div class="contents topic" id="table-of-contents">
<p class="topic-title">Table of Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#description" id="toc-entry-1">Description</a><ul>
<li><a class="reference internal" href="#features" id="toc-entry-2">Features</a><ul>
<li><a class="reference internal" href="#unicode-and-inline-editing" id="toc-entry-3">Unicode and Inline Editing</a></li>
</ul>
</li>
</ul>
</li>
<li><a class="reference internal" href="#documentation" id="toc-entry-4">Documentation</a><ul>
<li><a class="reference internal" href="#screenshots" id="toc-entry-5">Screenshots</a></li>
</ul>
</li>
<li><a class="reference internal" href="#download" id="toc-entry-6">Download</a><ul>
<li><a class="reference internal" href="#tools" id="toc-entry-7">Tools</a></li>
</ul>
</li>
<li><a class="reference internal" href="#reporting-bugs" id="toc-entry-8">Reporting Bugs</a></li>
<li><a class="reference internal" href="#installation" id="toc-entry-9">Installation</a><ul>
<li><a class="reference internal" href="#dependencies" id="toc-entry-10">Dependencies</a></li>
<li><a class="reference internal" href="#portability" id="toc-entry-11">Portability</a></li>
</ul>
</li>
<li><a class="reference internal" href="#copyright-and-license" id="toc-entry-12">Copyright and License</a></li>
<li><a class="reference internal" href="#authorship" id="toc-entry-13">Authorship</a></li>
</ul>
</div>
<!-- 1  Description
  1.1  Features
    1.1.1  Unicode and Inline Editing
2  Documentation
  2.1  Screenshots
3  Download
  3.1  Tools
4  Reporting Bugs
5  Installation
  5.1  Dependencies
  5.2  Portability
6  Copyright and License
7  Authorship -->
<div class="section" id="description">
<h1><a class="toc-backref" href="#toc-entry-1">Description</a></h1>
<p>This is a fork of <a class="reference external" href="http://github.com/blais/xxdiff">xxdiff</a>, a graphical file and
directories comparator and merge tool.  See there for full information about this
program, including documentation and more instructions.</p>
<div class="section" id="features">
<h2><a class="toc-backref" href="#toc-entry-2">Features</a></h2>
<ul class="simple">
<li>Comparing <strong>two</strong> files, <strong>three</strong> files, or two <strong>directories</strong>
(shallow and recursive);</li>
<li><strong>Horizontal diffs</strong> highlighting;</li>
<li>Files can be <strong>merged</strong> interactively and resulting output
visualized and saved;</li>
<li>Has features to assist in performing <strong>merge reviews/policing</strong>;</li>
<li>Can <strong>unmerge CVS conflicts</strong> in automatically merged file and
display them as two files, to help resolve conflicts;</li>
<li>Uses <strong>external diff program</strong> to compute differences: works with
GNU diff, SGI diff and ClearCase's cleardiff, and any other diff
whose output is similar to those;</li>
<li>Fully customizable with a resource file;</li>
<li>Look-and-feel similar to Rudy Wortel's/SGI xdiff, it is desktop
agnostic (i.e. will work equally well with KDE or Gnome);</li>
<li>Features and output that ease integration with scripts.</li>
</ul>
<p><strong>xxdiff</strong> was (and probably still is) tested daily in a merge
reviewing/policing context by more than 50 engineers at <a class="reference external" href="http://www.discreet.com">discreet</a>, and since this task is a
significant part of their development process, many of the features
are a direct result of suggestions from these people while the author
was working there.</p>
<div class="section" id="unicode-and-inline-editing">
<h3><a class="toc-backref" href="#toc-entry-3">Unicode and Inline Editing</a></h3>
<p><strong>xxdiff</strong> does not support comparing files encoded with Unicode.
Also, it does not support inline editing of the diffed files.  If you
need these features, you could try emacs or Meld (although both of
these lack some of the most interesting features of xxdiff).</p>
</div>
</div>
</div>
<div class="section" id="documentation">
<h1><a class="toc-backref" href="#toc-entry-4">Documentation</a></h1>
<ul class="simple">
<li><a class="reference external" href="https://htmlpreview.github.io/?https://github.com/blais/xxdiff/blob/master/doc/xxdiff-doc.html">User's Manual</a>
<em>(user's manual, all features, FAQ)</em></li>
<li><a class="reference external" href="doc/xxdiff-secrets.html">The almost secret nifty features of xxdiff</a></li>
<li><a class="reference external" href="doc/xxdiff-integration.html">Integrating xxdiff with scripts</a></li>
<li><a class="reference external" href="doc/xxdiff-scripts.html">Helper Scripts for xxdiff</a></li>
<li><a class="reference external" href="CHANGES">CHANGES</a> <em>(news, recent changes, history)</em></li>
<li><a class="reference external" href="TODO">TODO</a> <em>(future features, wishlist)</em></li>
</ul>
<div class="section" id="screenshots">
<h2><a class="toc-backref" href="#toc-entry-5">Screenshots</a></h2>
<ul class="simple">
<li><a class="reference external" href="doc/screenshots/gallery/index.html">Screenshots</a></li>
</ul>
</div>
</div>
<div class="section" id="download">
<h1><a class="toc-backref" href="#toc-entry-6">Download</a></h1>
<ul>
<li><p class="first">Source code can be found in the public GitHub repository, here:</p>
<blockquote>
<p><a class="reference external" href="http://github.com/blais/xxdiff">http://github.com/blais/xxdiff</a></p>
</blockquote>
<p>There are no releases. Pick up the source for from Github.</p>
</li>
</ul>
<div class="section" id="tools">
<h2><a class="toc-backref" href="#toc-entry-7">Tools</a></h2>
<p><strong>xxdiff</strong> comes with a bunch of wrapper Python scripts that invoke xxdiff in
creative ways.  The author has been using these for a long time now and decided
for version 3.0 to clean them up and make them a little more generic so everyone
can use them.  As of version 3.2, the standalone scripts have been refactored a
great deal, to share code together and to make them more stable.  All this code
is now distributed with xxdiff, in an <tt class="docutils literal">xxdiff</tt> Python package, which you can
leverage to build your own file transformation scripts around xxdiff.</p>
<p>See the document <a class="reference external" href="doc/xxdiff-scripts.html">Helper Scripts for xxdiff</a> for full
details.</p>
<p>The scripts are available in the xxdiff distribution.  To install them and the
accompanying Python package, use the standard distutils procedure:</p>
<pre class="literal-block">
su -  # before root
cd xxdiff-3.x
python setup.py install
</pre>
<p>Other tools can be found in the distribution under the tools/ directory (CVS,
ClearCase, etc.).</p>
</div>
</div>
<div class="section" id="reporting-bugs">
<h1><a class="toc-backref" href="#toc-entry-8">Reporting Bugs</a></h1>
<ul class="simple">
<li><a class="reference external" href="https://github.com/blais/xxdiff/issues">Reporting Bugs</a>
<em>(bugs and feature requests)</em></li>
</ul>
</div>
<div class="section" id="installation">
<h1><a class="toc-backref" href="#toc-entry-9">Installation</a></h1>
<div class="section" id="dependencies">
<h2><a class="toc-backref" href="#toc-entry-10">Dependencies</a></h2>
<p>Build dependencies are:</p>
<ul class="simple">
<li>Qt5, Qt6 or higher</li>
<li>A C++ compiler (g++ or clang), flex and yacc</li>
</ul>
<p>Runtime dependencies are:</p>
<ul class="simple">
<li>Qt5, Qt6 or higher</li>
</ul>
</div>
<div class="section" id="portability">
<h2><a class="toc-backref" href="#toc-entry-11">Portability</a></h2>
<p>The Qt6 version of xxdiff was only tested on Fedora GNU/Linux and Ubuntu Linux.</p>
</div>
</div>
<div class="section" id="copyright-and-license">
<h1><a class="toc-backref" href="#toc-entry-12">Copyright and License</a></h1>
<p>xxdiff Copyright (C) 2001-2022  Martin Blais.  All Rights Reserved.</p>
<p>This code is distributed under the <a class="reference external" href="COPYING">GNU General Public License</a>;</p>
</div>
<div class="section" id="authorship">
<h1><a class="toc-backref" href="#toc-entry-13">Authorship</a></h1>
<ul class="simple">
<li>Martin Blais &lt;<a class="reference external" href="mailto:blais&#64;furius.ca">blais&#64;furius.ca</a>&gt;</li>
<li>Port to Qt4 by Alexandre Feblot &lt;<a class="reference external" href="mailto:alexandre.feblot&#64;gmail.com">alexandre.feblot&#64;gmail.com</a>&gt;</li>
<li>Port to Qt5 and Windows 7 by Rene J.V. Bertin &lt;<a class="reference external" href="mailto:rjvbertin&#64;gmail.com">rjvbertin&#64;gmail.com</a>&gt;</li>
<li>Port to Qt6 by Lior Silberman &lt;<a class="reference external" href="mailto:lior3.1415+xxdiff-qt6&#64;gmail.com">lior3.1415+xxdiff-qt6&#64;gmail.com</a>&gt;</li>
</ul>
</div>
</div>
</body>
</html>
